package com.ruoyi.quartz.util;

import java.text.ParseException;
import java.util.Date;

import org.quartz.CronExpression;

/**
 * cron表达式工具类
 *
 * @author ruoyi
 *
 */
public class CronUtils {
    /**
     * 返回一个布尔值代表一个给定的Cron表达式的有效性
     *
     * @param cronExpression Cron表达式
     * @return boolean 表达式是否有效
     */
    public static boolean isValid(String cronExpression) {
        return CronExpression.isValidExpression(cronExpression);
    }

    /**
     * 返回一个字符串值,表示该消息无效Cron表达式给出有效性
     *
     * @param cronExpression Cron表达式
     * @return String 无效时返回表达式错误描述,如果有效返回null
     */
    public static String getInvalidMessage(String cronExpression) {
        try {
            // 尝试创建CronExpression对象来验证表达式有效性
            new CronExpression(cronExpression);
            return null;
        } catch (ParseException pe) {
            // 如果解析异常,返回异常信息
            return pe.getMessage();
        }
    }

    /**
     * 返回下一个执行时间根据给定的Cron表达式
     *
     * @param cronExpression Cron表达式
     * @return Date 下次Cron表达式执行时间
     * @throws IllegalArgumentException 当cron表达式无效时抛出异常
     */
    public static Date getNextExecution(String cronExpression) {
        try {
            // 创建CronExpression对象
            CronExpression cron = new CronExpression(cronExpression);
            // 获取下一个有效执行时间
            return cron.getNextValidTimeAfter(new Date(System.currentTimeMillis()));
        } catch (ParseException e) {
            // 解析异常时抛出非法参数异常
            throw new IllegalArgumentException(e.getMessage());
        }
    }
}

